Edit Task: NonRecurringPeriodicWindows
Format
SCHED / EditTask '<TaskName>' NonRecurringPeriodicWindows <# periodic definitions> <Frequency1> <Period1Start> <Period1Stop> <Epoch (custom only)> <Interval (custom only)> '<Period1Comment>' <# Inside Windows> <Per1Window1Start> <Per1Window1Duration> '<Per1Window1Comment>' ... <Per1WindowNStart> <Per1WindowNDuration> '<Per1WindowNComment>' ... PeriodicDefinitionN
Description
The NonRecurringPeriodicWindows attribute under EditTask defines a user-set amount of periodic windows for the task. This attribute may only be used if the RecurringType attribute is set to SingleInstance. Overlapping availabilities are merged into a single availability with the earliest start time and latest stop time for non-recurring periodic windows. Any previous periodic windows are deleted. For more information on parameters, see the description of the Periodic Window Definition Form.
Parameters
| Parameter | Description |
|---|---|
| # Periodic Definitions | An integer value indicating the number of periodic definitions contained within the command. |
| Frequency | Options are Yearly, Monthly, Weekly, Daily, Hourly, Minutely, and Custom. |
| Period Start/Stop | The format is YYYY/MM/DD_HH:MM:SS or YYYY/MM/DD_HH:MM:SS.fff. |
| Epoch | Epoch is only used if the frequency option is "Custom"; otherwise, the parameter should not be included in the command. The parameter should be in the format -- YYYY/MMM/DD_HH:MM:SS or YYYY/MM/DD_HH:MM:SS.fff. |
| Interval | Interval is only used if the frequency option is "Custom", otherwise the parameter should not be included in the command. The parameter should be entered as a number in seconds(millisecond fidelity). |
| Comment | A string of text in single quotes of the comment for that period or window. Empty String is allowed. |
| # Inside Windows | An integer value that is required and may be zero if there are no definitions within the window. If the parameter value is zero, PerNWindow parameters should not be included. |
| PerNWindowNOffset | The parameter value format is based on the format of the frequency: Yearly: MM/DD_HH:MM:SS.fff (e.g. 11/12_10:04:05.100) Monthly: DD_HH:MM:SS.fff (e.g. 12_10:04:05.100) Daily: HH:MM:SS.fff (e.g. 10:04:05.100) Hourly: MM:SS.fff (e.g. 04:05.100) Minutely: SS.fff (e.g. 05.100) Can also be a number in seconds (millisecond fidelity). The offset is always anchored at the top of the windows frequency. For example, an offset of 1 hour for a daily recurrence would be 1:00:00 of that day. The start of the period has no effect on the offset other than for custom definitions. |
| PerNWindowNDuration | Enter as a number in seconds (millisecond fidelity). |
| PerNWindowNComment | A string of text in single quotes of the comment for the given inside window. |
Examples
Set a yearly non-recurring window that occurs every Jan 1, with a duration of 1000 seconds
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Yearly 2015/01/01_09:30:00 2015/01/03_00:00:00 '' 1 01/01_00:30:00 1000 'NonRecurring Yearly'
Set a monthly non-recurring window that occurs every 1st of the month, with a duration of 800 seconds
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Monthly 2015/01/01_09:30:00 2015/01/03_12:30:00 '' 1 01_12:30:00 800 ''
Set a weekly non-recurring window that occurs every Friday, with a duration of 100 seconds
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Weekly 2015/01/01_09:30:00 2015/01/03_12:30:00 '' 1 Fr_12:30:00 100 ''
Set a daily non-recurring window for a task, with a subwindow that occurs 34200 seconds after the start of each day.
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Daily 2015/01/01_00:00:00 2015/01/03_00:00:00 '' 1 34200 3600 ''
Set an hourly non-recurring window for a task, with a subwindow of 20 minutes.
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Hourly 2015/01/01_09:30:00 2015/01/01_12:30:00 '' 1 0 1200 ''
Set a minutely non-recurring window for a task, with a subwindow of 40 seconds.
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Minutely 2015/01/01_09:30:00 2015/01/01_10:30:00 '' 1 10 40 ''
Set a custom 2 day window for a task, with no subwindows.
SCHED / EditTask 'TaskA' NonRecurringPeriodicWindows 1 Custom 2015/01/01_00:00:00.000 2015/01/03_00:00:00.000 2015/01/01_00:00:00.000 360 '' 0
